1.2 Scheduler - IOCS Interface 


I/O Initiation 


A task issues an SVC to enter IOCS. I/O services for pretransfer processing are then 
executed at the software priority level of the requesting task. Once the I/O request has 
been initiated (or queued for initiation), an H.EXEC entry point is called to report the 
event to the CPU and swapping scheduler: 


Lntry Point 

H.EXEC,1 
H.EXEC, 2 
H.EXEC, 3 
H.EXE C,4 

Wait I/O Post Processing 


Event 

Interactive input starting 
Terminal output starting 
Wait I/O starting 
No-wait I/O starting 


A return will be made to IOCS from H.EXEC, 1, 2, or 3 only upon completion of the I/O 
request. Post transfer processing may then occur at the software priority level of the 
requesting task. 

No-Wait I/O Post Processing 

A return from H.EXEC, 4 will be made immediately after recording the no-wait I/O 
event. Since IOCS will also make an immediate return to the user task, no-wait I/O post 
transfer processing will occur as a task interrupt service. 

No-Wait I/O Completion Task Interrupt Service 

When the I/O handler interrupt service routine fields a completion interrupt for a no-wait 
I/O request, it will call the executive subroutine S.EXEC4 to report the event. The I/O 
queue entry associated with the call will be linked to the task interrupt list in the DQE of 
the task which made the I/O request. When the scheduler attempts to dispatch control to 
the task, it will discover that a task interrupt is outstanding. It should be noted that task 
interrupts are inhibited during execution of any system service on behalf of a task. It 
should also be noted that no task interrupt will be honored while a higher priority task 
interrupt is active. When the task interrupt is honored, control will be transferred to the 
IOCS routine specified in the Preemptive System Service Header of the I/O queue 
entry. Post transfer processing may then occur at the software priority level of the 
requesting task. When post processing of the no-wait I/O request is complete, the task 
interrupt service may be exited by a call to S.EXEC6 or H .EXEC, 12, 

No-Wait I/O Restrictions for System Services 

Post transfer processing for a no-wait I/O request is processed as a task interrupt. Task 
interrupts are not honored while the task is executing in a system service (PC .LE. TSA 
address). An exception to this rule is made for a task that is in a wait-for-any-no-wait- 
I/O-completion state. A task interrupt generated by the completion of no-wait I/O will 
be honored if the task is in the wait-for-any-no-wait-I/O-completion state. A system 
service desiring to do no-wait I/O may issue a series of no-wait calls followed by a wait- 
for-any-call. Care should be exercised to insure that all outstanding calls are completed 
as appropriate. 
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Scheduler - IOCS Interface - IOCS I/O SVC Processing Overview 


IOCS FROM SV< 


CONSTRUCT 
ENVIRONMENT 
FOR I/O 
INITIATION 


INITIATE I/O 


WAIT I/O 


NO-WAIT I/O 


POST 

TRANSFER 

PROCESSING 


COMPLETE • 


M.RTRN 

TO 

Xuser/ 


M.RTRN 

TO 

Xuser/ 


RECONSTRUCT 

INITIATION 

ENVIRONMENT 
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Scheduler - IOCS Interface - IOCS No-Wait I/O Post Processing Overview 


iOCS TASK iNTERRUPT 




NO RETURN 
CONTINUE TASK AT 
POINT OF INTERRUPT 
OR 

CONTINUE 
WAIT FOR ANY 
I/O COMPLETION 


NO RETURN 
CONTINUE TASK AT 
POINT OF INTERRUPT 
OR 

CONTINUE 
WAIT FOR ANY 
I/O COMPLETION 


NO RETURN 
CONTINUE TASK AT 
POINT OF INTERRUPT 
OR 

CONTINUE 
WAIT FOR ANY 
I/O COMPLETION 


830663 A 


MPX-32 

Technical Manual 


System Description 


1-5 












Scheduler - IOCS Interface - IOCS Post Processing Procedure 


FROM WAIT I/O SVC, 
OR FROM NO-WAIT 
TASK INTERRUPT 


POST TRANSFER 
PROCESSING 



830665A 


MPX-32 

Technical Manual 


System Description 


1-7 










Scheduler - I/O Interrupt - Interface, Procedures 

START 


I 



INCREMENT 

GLOBAL 

INTERRUPT 

COUNT 
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Scheduler - I/O Interrupt Interface, Reentrant Subroutines 


INTERRUPT SERVICE 
ROUTINES 
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Preemptive System Service List Entry Header Format 
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name 


is the name of a system module 
num is an entry point number (1,2,3,...) within the system module 

1.12.3 M.CL5E 

This macro marks a file closed to subsequent service. An end-of-file mark can. be 
written and a rewind can be performed. 

Calling Sequence: 

M.CLSE addr , [EOF] , [REW] 

addr is the FCB address 

EOF specifies an end-of-file mark is to be written 
REW specifies the file is to be rewound 

1.12.4 M.DFCB 

This macro creates a File Control Block (FCB) and sets the appropriate parameters and 
specifications common to I/O requests which will be issued for the file. 

Calling Sequence: 

M.DFCB label, 1 fc , [count], [addrl], [ add r2 ] , [addr3], 

[NWT ] , [NER], [DFI], 

[NST] , [RAN] , ["ASCI [LDR] [INT] [EVN| ,[536] 

Lb in) ,LnjdJ,LpckJ ,LoddJ , Lsooj 

label is the ASCII character string to be used as the symbolic label for the address of 
the FCB 

lfc is the 1-3 character ASCII string to be used as the logical file code in the FCB 

count is the transfer count (bytes) c~ 
addrl is the data transfer address 
addr2 is the error return address 

addr3 is the random access address expressed as the hexadecimal block number (zero 
origin) relative to the base of the random access file 
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NWT 


is the the no-wait I/O specification indicator 


NER 

DFI 

NST 

RAN 

ASC or BIN 


is the inhibit peripheral error processing indicator 

is the inhibit data formatting indicator 

is the inhibit status testing indicator 
is the random access mode indicator 

is the forced ASCII or forced binary mode specification, respectively, for 
read operations performed when the file code for this file is assigned to a 
card reader 


LDR or NLD is the skip leader or do not skip leader specification, respectively, when 
the file code for this file is assigned to a paper tape reader/punch device 

INT or PCK is the interchange or packed mode specification, respectively, when the 
file code for this file is assigned to a magnetic tape device 


EVN or ODD is the even or odd parity specification, respectively, when the file code 
for this file is assigned to a magnetic tape device 

556 or 800 is the 556 or 800 bpi tape density specification, respectively, when the 
file code for this file is assigned to a magnetic tape device 


1.12.3 M.DTC0E 

This macro creates an expanded File Control Block (FCB) and sets the appropriate 
parameters and specifications common to I/O requests which will be issued for the file. 

Calling Sequence: 

M.DFCBE label, lfc , [count], [addrl], [addr2], [addr3], [NWT], [NER], [DFI], 
[NST], [RAN], [ASC] [LDRl [iNTl [EVN] [556] 

LbinJ , Lnldj, LpckJ , LoddJ , LsooJ , 

[addr4] , [addr5] 

label is the ASCII character string to be used as the symbolic label for the 

address of the F CB 

lfc is the 1-3 character ASCII string to be used as the logical file code in the 

FCB 

count is the transfer count in bytes 
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1.12.7 MFCBEXP 

This macro defines a-* File Contra 
Program request. 

Calling Sequence: 



Pc. £> 


i — 


O' . -f o *-> 


up 


Block (FCB) to be used for an Execute Channel 


M.FC8EXP label,! fc [, [cpaddr], [tout], [PCP], [NWI], [NST], [ssize], [sbuffer], 
— — - [nowaltj [nowaiterror], [waiterror], [psize], [ppciadr] 


label 



cpaddr 


tout 

PCP 

NWI 

NST 

ssize 

sbuffer 


is the ASCII string to use as the symbolic label for the address of the 
FCB 

is the logical file code, word 0, bits 8-31 of the FCB 

the logical address of the channel program to be executed 

a timeout value specified in seconds 

specifies physical channel program 

specifies no-wait I/O request 

specifies status checking not requested 

the size of the user specified sense buffer 

the address of the user specified sense buffer 


nowait 

nowaiterror 

waiterror 

psize 

ppciaddr 


normal no-wait end action return address 
no-wait end action error return address 
wait end action error return address 
size of PPCI status buffer to use 
PPCI end action address 


1.12.8 K/LFWRD 

This macro advances the current address of a blocked file by the number of file or record 
marks specified. 

Calling Sequence: 

M.FWRD addr, [R] [,num] 

addr is the F CB address 
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2.7 Controller Definition Table (COT) 

• 

The Controller Definition Table (CDT) is a system resident structure used to identify 
information required by handlers arid the I/O processor for a specific controller. The 
CDT is built by the SYSGEN process, one for each controller configured on the system. 
The CDT identifies devices (UDTs) associated with the controller, the handler address 
associated with the controller, and defines Other pertinent controller information. 


Word 

0 

1 

2 


7 8 


15 16 


23 24 


31 


Strinq forward address (CDT.FIOQ) 

String backward address (CDT.BIOCi) 

Link priority 
(CDTJ-PRI) | 

See Note T 1 

Number of 
entries in list 
(CDT.IOCT) ‘ 

See Note 2 

1 

Class 

(CDT. CL AS) 

See Notee 3 

: 

Reserved 

\ 

CDT index (CDT.IN 

DX) 

Device type \ 

code — > 

(CDT.DTC) 

Interrupt 
priority level 
(CDT.IPL) 

Number units 
on controller 
(CDT.NUOC) 

Number requests 

outstanding 

(CDT.IORO) 

Channel 
. number 
(CDT.CHAN) 

Subaddress 
of first device 
(CDT.SUBA) 

Program number 
if reserved . 
(CDT.PNRC) 

Interrupt handler address (CDT.SIHA) or controller 
information block (CDT.CIF) 

Flags 

(CDT.FUGS) 
See Note 4 

UDT address of first device on controller 
(CDT.UDT A) 

I/O status 
(CDT.IOST) 
See Note 5 

TI address (CDT.TI AD) or, 2-1 ^ 4 

STaddress if extendedT/O (CDT.SIAD) ^ 

T'Q (L 

UDT address unit C 

* (CDT.UTO) 

UDT address Unit 1* (CDT-UTlf 

_ _ 


— 8 


23 


UDT address unit 15* (CDT.UTF) 


♦Initialized by SY5GEN 
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Notes 


1. Always zero (head cell) 

2. Number of entries in list (zero if none) 

3. Bits in CDT.CLAS are assigned as follows. 

X’OD' TCW type with extended addressing capability 
X'OE 1 TCW type 
X’OF* Extended I/O 

4. Bits in CDT.FLGS are assigned as follows. 

0 Extended I/O device (CDT.FCLS) 

1 I/O outstanding (set by handler, reset by IOCS) (CDT.IOU1) 

2 GPMC device (CDT.GPMC) 

3 Set if initialization (INC) needs to be performed for this controller 
(CDT.FINT) 

4 Set if D class (16MB GPMC) (CDT.XGPM) 

5 Used only when IOQs are linked to the CDT. Set when SIO is accepted by 
controller. Reset when IOQ is unlinked from CDT or when I/O is reported 
complete to IOCS in the case of operator intervention type errors 
(CDT.IOU5). 

6 If set, IOP controller (CDT.IOP) 

7 If set, controller malfunction (CDT.MALF) 

3.. Bits in CDT.IOST are assigned as follows. 

0 If set, IOQ linked to UDT (CDT.NIOQ) 

1 Multiplexing controller (CDT.MUXC) 

2 If set, use standard XIO interface 

3 If set, D-class GPMC (CDT.XGPS) 

4 If set, cache controller (CDT.CAC) 

5 If set, H.F8XIO has determined if the controller is pre-8512-2 or not 
(CDT.CKFL) 

6 If set, controller not pre-8512-2 (CDT.FLOW) 

. 7 Reserved for FMS 

6. CDT.SIZE = 24 W 


2-30 


System Tables 
and Variables 


MPX-32 
Technical Manual 



2.8 Device Context Area (DCA) 

A Device Context Area (DCA) exists for each active subchannel and serves as a storage 
area for information regarding the subchannel and its operation. The DCAs are 
physically located at the end of each device dependent handler (H.??XIO). The first 33 
words of each DCA are identical; however, additional words may be added to suit the 
needs of the particular device. The following represents the first 33 words of each DCA. 

0 7 8 13 16 23 24 31 
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os V/» ^ Is) »-< O 


Notes 


1. Bits in DCA.FLAG are assigned as follows. 

If set, interrupts not expected 
If set, HIO issued at LI.XIO 
If set, HIO needs to be reissued 
If set, device rewinding or seeking 
If set, sense issued without an IQQ **» — 

If set, device is an XIO magnetic tape 
-15 Reserved for common subroutine usage 
16-23 Reserved for device dependent handler usage 

2. This UDT address is the UDT address of the device for which a SIO or HIO was issued 
when a status stored response was generated on behalf of this device. It indicates 
the need to reissue the I/O request for that device. 

3. Time out values corresponding to opcodes 0 through F (16 entries).—*. 
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Dispatch Queue Entry (DQE) Table 


Word # 

Byte 

(Decimal) 

(Hex) 

0 

0 

1 

4 

2 

8 

3 

C 

4-3 

10 

6-7 

18 

8-9 

20 

10 

28 

11 

2C 

12 

30 

13 

34 

14 

38 

15 

3C 

16 

40 

17 

44 

18 

48 

19 

4C 

20 

50 

21 

54 

22 

58 

23 

5C 

24 

60 

25 

64 

26 

68 

27 

6C 

28 

70 

29 

74 

30 

78 

31 

7C 

32 

80 

33 

84 

34 

88 

35 . 

8C 

36 

90 

37 

94 

38-40 

98 

41 

A4 

42-43 

A8 

44-51 

BO 

52 

DO 

53 

D4 

54 

D8 

55 

DC 

56 

EO 

57 

E4 
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Item Description 


Byte 

(Hex) Symbol 

0 DQE.SF String forward linkage address; 

Standard linked list format; 

Contains address of next (top-to-bottom) entry in chain. 

4 DQE.SB String backward linkage address; 

Standard linked list format; 

Contains address of next (bottom-to-top) entry in chain. 

8 DQE.CUP Current user priority; 

Field length = IB; 

Standard linked list format; 

This priority is adjusted for priority migration based on 
situational priority increments. Situational priority increments 
are based on the base level priority (DQE.BUP) of the task. 

DQE.BUP Base priority of user task; 

Field length = IB; . 

Used by scheduler to generate DQE.CUP (current priority) based 
on any situational priority increments. 

DQE.IOP I/O priority; 

Field length = IB; 

Initially set from base priority; 

Used for I/O queue priority. 

DQE.US State chain index for this user task; 

Field length = IB; 

Range: Zero thru X'lE*; 

Indicates current state of this task e.g., ready-to-run priority, I/O 
wait, resource block, etc.. 

Label Index Description 

DQE is available (in free list) 

T ask activation in progress 
Task is currently executing task or is 
preempted time distribution task in quantum 
stage 1 

Task is ready to run (PRI. LEV. 1-54) 

T ask is ready to run (PRI. LEV. 55) 

Task is ready to run (PRI. LEV. 56) 

Task is ready to run (PRI. LEV. 57) 

Task is ready to run (PRI. LEV. 58.) 

Task is ready to run (PRI. LEV. 59) 

Task is ready to run (PRI. LEV. 60) 

Task is ready to run (PRI. LEV. 61) 

Task is ready to run (PRI. LEV. 62) 

T ask is ready to run (PRI. LEV. 63) 

Task is ready to run (PRI. LEV. 64) 

Task is waiting for terminal input 


FREE 00 
PREA 01 
CURR 02 


J5J3BX-- — 03' — 
SQ55 04 

SQ56 05 

SQ57 06 

SQ5 8 07 

SQ59 08 

SQ60 09 

SQ61 0A 

SQ62 0B 

SQ63 0C 

SQ64 0D 

SWTI 0E 


2-38 


System Tables 
and Variables 


MPX-32 
Technical Manual 


C DQE.NUM 


DQE.TAN 

10 DQE.ON 

18 DQE.LMN 

MPX-32 
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SWIO OF 

SW5M 10 
SW5R 11 
SWLO 12 
SUSP 13 


RUNW 14 


HOLD 13 
ANYW 16 


SWDC 17 
SWDV 18 
SWFI 19 

MRQ 1A 

SWMP IB 
SWGQ 1C 
CPU ID 
RPU IE 


Task is waiting for I/O 
Task is waiting for message complete 
Task is waiting for run req complete 
T ask is waiting for low speed output 
Task is waiting for: 

1) timer expiration, or 

2) resume request, or 

3) message interrupt 
T ask is waiting for: 

1) timer expiration, or 

2) run request 

Task is waiting for a continue req. 
Task is waiting for: 

1) timer expiration, or 

2) no-wait I/O complete, or 

3) no-wait msg complete, or 

4) no-wait run req complete, or 
3) message interrupt, or 

6) break interrupt 
Task is waiting for disc space 
T ask is waiting for dev allocation 
Task is waiting for file system 
T ask is waiting for memory 
Task is waiting for memory pool 
Task is waiting in general wait queue 
Current IPU task in execution 
IPU requesting state 


DQE entry number; 

Field length = IB; 

Used as an index to DQE address table (DAT); 

Range: One thru "N" (for MPL index compatibility); 

Used by scheduler to set C.PRNO to reflect the currently 
executing task. 

This value is also used as the MPL index. It is used by the 
scheduler to initialize the CPIX in the PSD before loading the 
map for this task. 

Task activation sequence number; 

Field length = 1W; 

This number is assigned by the activation service and uniquely 
identifies a task. 

NOTE: The most significant byte of this value is the DQE entry 
number and may be accessed as DQE.NUM. 


Owner name; 
Field length = ID 


Load module name; 

Field length = ID 
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20 


DQE.PSN 


28 


2C 


2-40 


Pseudonym associated with task; 

Field length = ID; 

This parameter is an optional argument accepted by the pseudo 
task activation service. It may be used to uniquely identify a task 
within a subsystem, for example, multibatch. It contains 
descriptive information useful to the system operator or to other 
tasks within a subsystem. Conventions used to generate a 

pseudonym are determined by the associated subsystem. A 
system-wide convention should be used to establish pseudonym 
prefix conventions to avoid confusion between subsystems. 


DQE.USW User status word; 

Field length = 1W 

DQE.USHF Scheduling flags; 

Field length = 1W; 

Used by the scheduler to indicate special status conditions. 


Bit 

Label 

Description 

00 

DQE.LPI 

Load protection image requested 

01 

DQE.SING 

Single copy load module 

02 

DQE.INDC 

Task is indirectly connected 

03 

DQE.PRIV 

Task is privileged 

04 

DQE.MSGR 

Task has message receiver 

03 

DQE.BRKR 

Task has break receiver 

06 

DQE.QS1X 

Task quantum stage 1 expired 

-Q7 

DQE.QS2X 

Task quantum stage 2 expired 

08 

DQE.INER 

Inswap I/O error 

09 

DQE.WIOA 

Wait I/O request outstanding 

10 

DQE.WIOC 

Wait I/O complete before in-progress 
notification 

11 

DQE.INMI 

Inhibit message pseudo interrupt 

12 

DQE.BAOR 

Batch origin task 

13 

DQE.TMOR 

Running in TSM environment 

14 

DQE.ABRT 

T ask abort in progress 

15 

DQF.PRXT 

.,Task is in preexit state 

16 

DQE.RRMD 

Run receiver mode 

17 

DQE.WMSA 

Wait-send msg outstanding 

18 

DQE.WMSC 

Wait msg complete before link to wait 
queue 

19 

DQE-.WRRA 

Wait mode send run request outstanding 

20 

DQE.WRRC 

Wait mode send run request complete 
before link to wait queue 

21 

DQE.DBAT 

Debug associated with task 

22 

DQE.RT 

Real time task 

23 

DQE.TDID 

Time distribution task initial dispatch. 


Set by: 

1. H.ALOC1 on activation of T/D task 

2. S.EXEC51 when task is linked to WAIT 
state 

3. H.EXEC7 on completion of inswap or 
other memory request 

System Tables MPX-32 

and Variables Technical Manual 



Cleared by S.EXEC20 on initial dispatch 
of task after activation, wait-state 
termination, or inswap. 


24 

DQE.DELP 

Task delete in progress 

25 

DQE.ABRA 

Task abort (with abort receiver) 
progress 

26 

DQE.ABRC 

Abort receiver established 

27 

DQE.ADIN 

Asynchronous abort/delete inhibited 

28 

DQE. A DDF 

Asynchronous delete deferred 

29 

DQE.INAC 

Task is inactive 

30 

DQE.AADF 

Asynchronous abort deferred 

31 

DQE.ACTT 

Activation timer in effect 


30 DQE.MSD Physical address of MIDL in TSA; 

Field length = 1W 

34 Reserved Field length = 1W 

38 DQE.MMSG Maximum number of no wait messages allowed to be sent by this 

task; 

Field length = IB 

DQE.MRUN Maximum number of no-wait run requests allowed to be sent by 
this task; 

Field length = IB 

DQE.MNWI Maximum number of no-wait I/O requests allowed to be 
concurrently outstanding for this task; 

Field length = IB 

DQE.GQFN Contains the generalized queue (SWGQ) function code; 

Field length = IB 

01 = Queued for volume resource (QVRES) 

02 = Queued for ART space (QART) 

03 = Queued for mount in progress (QMNT) 

04 = Queued for resourcemark lock (QRSM) 

05 = Reserved for eventmark (QEVM) 

06 = Queued for read wait for writer (QGEN) 

07 = Queued for Shared Memory Table (QSMT) 

08 = Queued p or synchronous resource lock (QSRL) 

09 = Queued ior Mounted Volume Table (QMVT) 

0A = Queued for dual port lock (QDPLK) 

3C DQE.UF2 Scheduling flags; 

Field length = IB 


Bit Label 


Description 


0 

1 

2 

3 

4 

5-7 


DQE.EDB Enable debug mode break 

DQE.GQTO Generalized wait queue time-out 

DQE.SYNC Task interrupts are synchronized 

DQE. JOB T ask is part of a job 

DQE.ACX ACX-32 task flag 

Reserved 
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DQE.IPUF 


DQE.NWIO 

DQE.SOPO 

DQE.CQC 

Reserved 

DQE.TIFC 


DQE.RILT 

DQE.UT51 


IPU flag byte 


Field length = IB 


Bit 

Label 

Description 

0 

DQE.IPUH 

IPU inhibit flag 

1 

DQE.IPUB 

PU bias flag 

2 

DQE.IPUR 

CPU only 

3 

DOE. OSD 

OS execution direction flag (set when PSD 
is in user area) 

4 

DQE.BASE 

Base register task 

5 

DQE.AbA 

Ada task 

6-7 


Reserved 


Number of no-wait I/O requests 
Field length = IB 


Priority bias only swapping control flags; 
Field length = IB 


Bit Label 


Description 


0 

1 

2-7 


DQE.GQPO SWGQ state priority based swapping 
DQE.BMAP Swap inhibit due to bit map access 
Reserved 


Current quantum count; 

Field length = 1W; 

Used by the scheduler to accumulate elapsed execution time for 
the task for comparison with the level unique stagel and stage2 
time distribution values. 


Field length = 1H 

Timer function code; 

Field length = IB; 

00 = Not active 

01 = Request interrupt 

02 = Resume program from suspend (SUSP) queue 

03 = Resume program from any-wait (ANYW) queue 

04 = Resume program from run-request-wait (RUNW) queue 
03 = Resume-program from generalized (SWGQ) queue 

06 = Resume program from peripheral device (SWDV) queue 

07 = Resume program from disc space (SWDC) queue 

Request interrupt (RI) level for timer; 

Field length = lB; 

Identifies the interrupt level to be requested upon timer 
expiration. 

User timer slot word 1; 

Field length = 1W; 

Current timer value; 

Contains negative number of timer units before time-out. 
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4C 


DQE.UTS2 User timer slot word 2; 

Field length = 1W; 

Reset timer value; 

Contains negative number of time units; 

Used to reset the current timer value when it expires. 

50 DQE.DSW Base mode debugger status word (PCALL); 

Field length=lW. 


54 


DQE.PRS Peripheral requirement specification; 
Field length = 1W; 

Bit Description 


0-7 Reserved 

8-15 Device type code 

16-23 Channel address 

24-31 Subchannel address or contains first word of SWGQ id 


58 DQE.PRM Peripheral requirements mask; 

Field length = 1W; 

X’OOFFOOOO' = Any device of this type code 

X’OOFFFFOO' = Any device of the specified type code on the 

specified channel 

X'OOFFFFFF' = The specified device as described by type 
code, channel, and subchannel address, or 
contains second word of SWGQ id. 


5C Reserved Field length = 3B- 

DQE.MST Static memory type specification; 

Field length = IB; 

01 = Class 'E* memory 

02 = Class 'H 1 memory 

03 = Class 'S' memory 

This field is sed to specify the type of memory required for 
inswap. 

60 DQE.PSSF Preemptive system service head cell 

String forward linkage address; 

Standard head cell format; 

Field length = 1W; 

Contains address of next (top-to-bottom) entry in chain. 


64 DQE.PSSB Preemptive system service head cell 

String backward linkage address; 

Standard head cell format; 

Field length = 1W; 

Contains address of next (bottom-to-top) entry in chain. 
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DQE.PSPR 


DGE.PSCT 


DQE.ILN 


DQE.RESU 

DQE.TISF 


DQE.TISB 


DQE.TIPR 


DQEoTICT 


DQE.SWIF 


Preemptive system service head cell 
Dummy priority (always = 0); 

Standard head cell format; 

Field length = IB* 

Preemptive system service head cell 
Number of entries in list; 

Standard head cell format; 

Field length = IB; 

Interrupt level number; 

Field length = IB; 

Identifies associated interrupt level for interrupt connected tasks. 

Reserved usage index 
Field length = IB 


T ask interrupt head cell 
String forward linkage address; 

Standard head cell format; 

Field length = 1W; 

Contains address of next (top-to-bottom) entry in chain. 


T ask interrupt head cell 
String backward linkage address; 

Standard head cell format; 

Field length = 1W; 

Contains address of next (bottom-to-top) entry in chain. 


T ask interrupt head ceil 
Dummy priority (always = 0); 
Standard head cell format; 
Field length — IB 

Task interrupt head cell 
Number of entries in list; 
Standard head cell format; 
Field length = IB; 


Swapping inhibit flags; 
Field length =’1B; 


Bit Label 


Description 


0 

1 

2 

3 

4 

5 


DQE.RESP 

DQE.LKIM 

DQE.IO 

DQE.OTSW 

DQE.TLVS 

DQE.FCUS 


Task is resident 

Task is locked in memory 

Task has unbuffered I/O in progress 

Task is outswapped 

Task is leaving system 

Task forced" unswappable during terminal 

output 


System Tables MPX-32 

and Variables Technical Manual 



6 


DQE.FCRS Task forced unswappable because swap 
file has not been allocated for it 
7 DQE.INOS Task is imbedded in the operating system 

DQE.UBIO Number of unbuffered I/O requests currently outstanding; 

Field length = IB. 


78 DQE.RRSF Run receiver head cell 

String forward linkage address; 

Standard head cell format; 

Field length = 1W; 

Contains address of next (top-to-bottom) entry in chain. 

7C DQE.RRSB Run receiver head cell 

String backward linkage address; 

Standard head cell format; 

Field length = 1W; 

Contains address of next (bottom-to-top) entry in chain. 


80 DQE.RRPR Run receiver head cell 

Dummy priority (always = 0); 
Standard head cell format; 

Field length = IB. 

DQE.RRCT Run receiver head cell 

Number of entries in list; 

Standard head cell format; 

Field length = IB; 

DQE.NSCT Number of map blocks out swapped; 
Field length = 1H. 


84 DQE.MRSF Message receiver head cell 

String forward linkage address; 

Standard head cell format; 

Field length = 1W; 

Contains add of next (top-to-bottom) entry in chain. 


88 DQE.MRSB Message receiver head cell 

String backward linkage address; 

Standard head cell format; 

Field length = 1W; 

Contains address of next (bottom-to-top) entry in chain. 
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8C DQE.MRPR Message receiver head cell 

Dummy priority (always = 0); 

Standard head cell format; 

Field length = IB. 

DQE.MRCT Message receiver head cell 
Number of entries in list; 

Standard head cell format; 

Field length = IB; 

DQE.NWRR Number of no-wait mode run requests outstanding; 
Field length = IB. 

DQE.NWMR Number of no-wait mode msg requests outstanding; 
Field length = IB. 


90 


DQE.RTI 


Requested task interrupt flags; 
Field length = IB; 


Bit Label Description 


0 

1 

2 

3 

4 
3 

6-7 


DQE.EA1R 

DQE.DBBR 

DQE.UBKR 

DQE.EA2R 

DQE.MSIR 


Reserved 

Priority 1 end action request. Used for 
preemptive system services. 

Debug break request 

User break request 

End action request (priority 2) 

Message interrupt request 
Reserved 


Reserved Field length = IB 


DQE.ATI 


Active task interrupt flags; 
Field length = IB. 


Bit Label Description 


0 

1 

2 

3 

4 
3 

6-7 


DQE.AEA1 

DQE.ADM 

DQE.AUB 

DQE.AEA 

DQE.AMI 


Reserved 

Active end action priority 1 
Active debug break 
Active user break 
Active end action priority 2 
Active message interrupt 
Reserved 


Reserved Field length = IB 
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94 

DQE.SAIR 

System action task interrupt request; 




Bit Label Description 



• 

0 DQE.DELR Request for delete of this task 

1 Reserved 

2 DQE.HLDR Hold task request 

3 DQE.ABTR Abort task request 

4 DQE.EXTR Exit task request 

5 DQE.SUSR Suspend task request 

6 DQE.RRRQ Run receiver mode request 

7 Reserved 



DQE.TAD 

TSA address (logical); 

Field length = 1W (byte 0 contains DQE.SAIR) 


98 

DQE.ABC 

Abort code; 

Field length = 3W 

n 


A4 

DQE.MPP 

Memory pool pointer; 
Field length = 1W 


A8 

DQE.SRID 

Used swapspace linked list; 
Fieia iength = 2W 


BO 

DQE.CDIR 

Load module RID at activation; 
Field length = 8W 



DQE.CVOL 

Current working volume at activation; 
Field length = 8W 


DO 

DQE.ACX1 

Outswap time; 
Field length = 1W 


D4 

DQE.ACX2 

Advance communication word 2; 
Field length = 1W 


D8 

DQE.MRQ 

Memory request doubleword; 
Reserved Field length=lB 



DQE.MEM 

Type of memory requested; 
Field iength = IB; 

01=Class 'E* memory 
02=Class 'H' memory 
03=Class 'S' memory 



DQE.MEMR 

Number of memory blocks required; 
Field length=lH; 
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DC 


DQE.MRT Memory request type code; 

Field length=lB; 

00=lnswap only 
01=Preactivation request 
02=Activation request 
03=Memory expansion request 
04=IOCS buffer request 
05=Shared memory request 
06=System buffer request 

I.f DQE.MRT equals 03, the next three bytes will contain the 
address of the Shared Memory Table entry. 

Reserved Field length=lB 

DQE.RMMR Map register for requested memory; 

Field length=lH 


E0 DQE.MAPN Inclusive span of maps in use; 

Field length=lH 

DQE.CME Number of swappable class map blocks currently allocated; 
Field length=lH 


E4 DQE.CMH Number of swappable class 'H' map blocks currently allocated; 

Field length=lH 

DQE.CMS Number of swappable class 'S’ map blocks currently allocated; 
Field length=lH 
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2.14 File Assignment Table (FAT) 


The File Assignment Table (FAT) is used to provide an association between a logical file 
code (LFC) and a resource. It also coordinates access to the resource referenced via an 
LFC. The FAT is linked to the Unit Definition Table (UDT) and the Controller Definition 
Table (CDT) when the resource is allocated. 

The FAT must contain information related to the requestor of the resource such as 
position within the file (segment and byte within the segment) and current access mode. 
For efficiency considerations, information pertaining to allowable access modes, 
segmentation, and extendibility are also included. 


0 7 8 15 16 23 24 31 


VVUi u 
0 

Status 

Access flags 

CDT index (DFT.CDTX) 


bits 

(DFT.STB) 
See Note 1 

or system 
file code 
(DFT.ACF) 
See Note 2 



1 

Flags 

(DFT.FLGS) 
See Note 3 

Number of 
FPTs 
assigned 
(DFT.NAS) 

UDT index (DFT.UDTX) 

2 

Segment definition area address (DFT.SEGA) or 
Volume name for dismount messaqe (DFT.VNAM) 

3 

Relative file block position (DFT.POS) 

4 

Relative EGM block position (DFT.EQM) See Note 4 

5 

Relative EOF block number (DFT.EOF) 

6 

Current segment position 
in file (DFT.CSEG) or 
Device specification 
mask (DFT.MASK) 

Number of segments (DFT.NSEG) 

7 

Relative end block 
number of current 
segment (DFT.SEGE) or 
Unformatted medium 
identifier (MTF.REEL) 

Append record pointer (DFT.AREC) 

8 

File attributes field (DFT.ATTR) See 

Note 5 

9 

Append block number (DFT.ABLK) or 

Volume number for multivolume media (MTF.VOL) 

10 

Blocking buffer head ceil address (DF‘ 

f.BBA) 

11 

Associated 
VAT index 
(DFT.VATX) 

Number of 
opens on 
this FAT 
(DFT.OPCT) 

Current access 
mode (DFT.CACM) 

Resource type 
code (DFT.TYPE) 

12 

Address of parent directory resource descriptor (DFT.PDIR) 

13 

Relative offset of parent directory entry (DFT.DOFF) 

14 

Allocated Resource Table entry pointer (DFT.ARTA) 

15 

Assigned access restrictions (DFT.ACCS) See Note 6 
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Notes 


1. Bits in DFT.STB are assigned as follows. 

0 If set, file open 

1 If set, file opened read/write 

2 If set, permanent file 

3 If set, blocking buffer output active 

4 If set, unformatted medium 

5 If set, volume resource 

6 If set, read only access 

7 If set, TSM associated FAT 

2. Bits 04 In UFT.ACF are assigned as follows. 

Volume resource only: 

0-1 Reserved 

2 If set, "$" read on SYC ! 

3-4 Reserved 

Unformatted medium only: 

0 If set, mount message has been inhibited or tape is shared 

1 If set, multivolume tape 

2 If set, mount message has been output 

3 If set, tape at EOT 

4 If set, tape at BOT 

Bits 5-7 in DFT.ACF apply only to volume usage and will contain one of the 
following values. 

Value=0 Not a system file — 

Value=l SYC file 
Value=2 SGO file 
Value=3 SLO file 
Value=4 SBO file 

3. Bits in DFT.FLGS are assigned as follows. 

0 Blocking buffer present 

1 SMAP or DMAP assignment 

2 Reserved 

3 If set, file has been assigned to the NULL device * 

4 If set, this FAT entry is not in use 

5 If set, TSM I/O (task is swappable) — - 

6-7 Reserved 

4. Byte 3 of Word 4 contains tape density for high speed tape (DFT.DENS) and EOM 
does not apply (DFT.EOM). 

5. Bits in DFT.ATTR are assigned as follows. 

0 If set, file is automatically extendable 

1 If set, file is implicitly shared 

2 If set, file data has been modified 

3 If set, unblocked specified at assignment 

4 If set, file opened for random access 

5 If set, file opened in blocked mode 

6 If set, expanded FCB 

7 If set, resource descriptor opened for modify 
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8 If set, current access mode specified at assignment 

9 If set, resource to be marked blocked at close 

10 If set, enqueue inhibit 

11 If set, spool option requested 

12 If set, EOF update required 

13 Reserved for IOCS 

14 If set, file assigned to nonpublic volume 

13 If set, segmented file 

16 If set, task in resource queue when deleted 

17 If set, the date and time of last change field in the resource descriptor will 
not be changed on a rewrite 

18-31 Reserved 


6. Bytes in DFT.ACCS are assigned as follows. 

Bytes 0-1 Contain bit pattern from RR.ACCS if specified at assignment (see 

Section 2.31 for details on RR.ACCS). If not specified, contains 
the bit pattern from the appropriate access restriction field 
(RD.AOWNR, RD.AUGRP, RD.AOTHR) in the resource 
descriptor. See M.RDCOM, Section 2.41.1 for details. 


Byte 2 


Byte 3 


Bits are assigned as follows. 

0 If set, assigned for explicit shared use 

1 If set, assigned for exclusive use 

2-7 Reserved 

Contains the bit pattern specified in byte 3 of RD.SFLQS in the 
associated resource descriptor. See M.RDSPD, Section 2.41.2 for 
details. 
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2J.5 Fiie Control Block (FC8) 


The File Control Block (FCB) is used to convey information about requested I/O 
operations and to report their status to the requestor. The table entry is generally 
located in the t ask's ad dress space. 

The task's FCB is linked to the File Assignment Table (FAT) when the resource is 
opened. This completes the logical connection from the task to the requested resource 
for subsequent use. The FCB is then linked to an I/O Queue (IOQ) entry when an 
operation for that logical connection is requested. When this is done, the status for the 
requested operation code is posted in the respective FCB. 


Word 0 


3 4 


7 8 


11 12 


13 16 


23 24 


31 


0 

Reserved 

Opcode 

(FCB.OPCD) 

Logical file code (FCB.LFC) 

\ Jw 

Quantity (FCB.TCW) 

Data Address 

r 2 

General control 
flags (FCB.GCFG) 

Special flags 
(FCB.SCFG) 

Random access 
address (FCB.CBRA) 

Console teletype 
flag (FCB.CONF) 


Status flags 
(FCB.SFLG) 

Test status 

DCC status 

Device status 


I 


c/ 


4 

5 

6 

7 

8 

9 

10 
11 
12 

13 

14 


"? 15 

O 


j H 

1% 

I S' 

( ^ 

2* 

l 

V 

w 

3^ 

J4 


Record length (bytes) (FCB.RECL) 


Reserved 


Special 

status 

(FCB.SPST) 


Reserved 


Index to FPT 


Reserved 


I/O queue address (FCB.IOQA) 


Wait I/O error return address (FCB.ERRT) 


FAT address (FCB.FATA) . 


Expanded data address (FCB.ERWA) 


Expanded transfer quantity (bytes) (FCB.EQTY) 


Expanded random access address (FCB.ERAA) . 


Extended I/O status word 1 (FCB.IST1) 


Extended I/O status word 2 (FCB.IST2) 


Reserved 


Reserved 


No-wait I/O normal end action service address 
(FCB.NWOK) 


No-wait I/O error end action service address 
(FCB.NWER) 


User-supplied blocking buffer address and number of 192 W buffers (FCB.BBA) 
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WORDO 


Bits 0-3 This field is always zero. 

Bits 4-7 Operation code - A single hexadecimal digit specifies the type of 

function requested of the device handler. The allowable functions and 
their definitions are unique to each peripheral device. 

Bits 8-31 Logical file Code - Any combination of three ASCII characters is 
allowed. 


WORD 1 

Note: Words 8 and 9 are used instead of Word 1 if Bit 6 of Word 2 is set. 

Bits 0-11 Quantity - Three hexadecimal digits specify the number of data items 
to be transferred. This quantity must include the carriage control 
character, if applicable. The transfer quantity is in units determined 
by the address in bits 12-31. 

Bits 12, Format Code - These bits specify byte, halfword or word addressing 

30,31 for data transf6rs. They are interpreted as follows: 

Type of F C 

T ransf er (12) (30,31) 

Byte 0 
Byte 1 
Byte 2 
Byte 3 

Left Halfword 
Right Halfword 
Word . 


1 00 
1 01 
1 10 
1 11 
0 01 
0 11 
0 00 


If a halfword or word transfer is specified for a device which accepts 
only bytes, IOCS adjusts the quantity accordingly. If a byte transfer 
is specified for a device which accepts only halfwords or words, IOCS 
will adjust the quantity accordingly if the number of bytes is an even 
multiple of the requested transfer mode and the data address is on the 
correct boundary. Otherwise, the request is treated as a specification 
error. 

Bits 13-29 Data Address - The initial address data areas for read or write 
operations. 
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WORD 2 


Bits 0-7 General Control Specifications - These eight bits enable the user to 

specify the manner in which an operation is to be performed by 
IOCS. The interpretation of these bits is shown below: 


Bit Meaning 


0 If set, IOCS wiii return to the user immediately after the I/O 
operation is queued. If reset, IOCS will exit to the calling program 
only when the requested operation has been completed. 

1 If set, error processing will not be performed by either the device 
handler or IOCS. An error return address is ignored and a normal 
return will be taken to the caller, however the device status will be 
posted in the FCB (unless bit 3 is set). If reset, normal error recovery 
will be attempted. Normal error processing for disc and magnetic 
tape is automatic error retry. Error processing for unit record 
devices except the system console is accomplished by IOCS typing the 
message "INOP" to the console which allows the operator to retry or 
abort the I/O operation. If the operator aborts the I/O operation, or 
if automatic error retry for disc or magnetic tape is unsuccessful, an 
error status message is typed to the console and the error return 
address will be taken if provided; otherwise, the task is aborted. 

2 If set, data formatting is inhibited. Otherwise, data formatting is 
performed by the appropriate device handler. See Bit 8 for further 
explanation. 

3 If set, the device handlers perform no status checking and no status 
information is returned. Hence all I/O will appear to complete 
without error. Otherwise, status checking is performed and status 
information is returned as necessary. 

4 If set, file accessing will occur in the random mode. Otherwise, 
sequential accessing will be performed. 

3 If set, a blocked file is specified (disc or tape assignments only). 

6 Expanded FCB present (Words 8-15). This takes advantage of a larger 
I/O transfer quantity in bytes, a 24-bit addressing field, and a 32-bit 
random access address. For Extended I/O operations, up to two 
interrupt status words are then returned after I/O complete. When 
this bit is set, IOCS assumes the FCB is 16 words long. The 
information in Words 8 and 9 is used instead of the data in Word 1. 
Also, the random access address in Word 10 is used instead of the data 
in word 2. 

7 This bit is reserved for internal IOCS use. If set, it indicates the 
user's FCB is being used for physical I/O during blocked data handling 
and the FCB parameters are in the task's scratchpad. 
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Bit 8 


Device Format Definition - If set, special definitions for 7-track 
magnetic tape, ALIMs, etc. are indicated in bits 9-12. Normally, bit 8 
is examined only when bit 2 (data formatting inhibit) is set. The 
meaning is interpreted as shown in Section 2.15.1. 

Bits 9-12 Special Control Specification - this field contains device control 
specifications unique to certain devices. Interpretation and 
processing of these specifications are performed by the device 
handlers. A bit setting is meaningful oniy when a particular type of 
device is assigned as indicated in Section 2.15.1, columns 2 and 3. 
(Column 1 indicates default control). 

Bits 13-31 Random Access Address - This field contains a block number (zero 
origin) relative to the beginning of the disc file, and specifies the base 
address for read or write operations. 

If bit 6 of Word 2 is set, the expanded random access address in Word 
10 (FCB.ERAA) is used instead of bits 13-31. 

For devices where random access is invalid, bits 13-31 have the following assignments: 

Bit 13 If set, software read flow control required (FCB.RXON). 

Bits 24-31 Console Teletype Type Control Parameter Block Flag Type. 

For High Speed Data (HSD) interface applications, Word 2 bit meanings are as follows: 

Bit 8 Request Device Status After Transfer - This bit indicates an IOCB 

should be added to the IOCL to retrieve device specific status after 
the data transfer has completed. 

Bit 9 Send Device Command Prior to Data Transfer - This bit indicates an 

IOC8 should prefix tffe data transfer to transmit a device command 
word to the device. The value sent is the 32-bit expanded random 
access address. 

Bit 10 Disable Timeout for this Request - This bit indicates the operation 

will take an indeterminable period of time and the handler should wait 
an indefinite period of time for the I/O to complete. This generally 
only has meaning on read operations. 

Bit 11 Set UDDCMD from Least Significant Byte of Word 2 - This bit 

indicates the UDDCMD byte in the data transfer IOCB should be set 
to the least significant byte of the random access field of the FCB. 
This provides the ability to pass additional control information to the 
device without modifying the device driver. * 

Bits 24-31 If bit 11 is set, these bits define the UDDCMD field of the generated 
IOCB, overriding the default value from a handler table. 
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Device 


Default 
(Bit 2=0'' 


Override 

'’Bit 2=1') BitB Bit 9 Bit 10 Bit 11 Bit 12 


Card Reader 
<’CR' 1 

Read Auto 
Select Mode. 

First column - 
Rows 2-5, all 
punched = binary, 
no translation, 
max. 120 bytes. 

Not all punched = 
ASCII, translate, 
max 80 bytes. 

EOF = column 1, 
Rows 2-5 only 
punched. Binary, 
no translation (X'OF'). 
Max 120 bytes. 

See Bit 8. 

0=ASCII read 
l=Binary read 





Line 

Printer (LP) 

Interpret first 
character as 
carriaqe 
•control. 

No carriage 

control 

interpretation 






High Speed 
Data (HSD) 
Interface 
(Generic Handler") 



See Word 2 definition 

See Word 2 
definition 

See Word 2 
definition 

See Word 2 
definition 

See Word 2 
definition 

Paper Tapp • 
Reader (PT) 

Read in formatted 
mode, skippinq leader. 

Read unformatted 

0=Do not skip leader 
l=Skip leader 





(MT 9- 
track only) 

fsl/A 







Discs 

(DM,DF,FL) 

Report EOF if 
X'OFEOFEOF 1 en- 
countered in word 
0 of 1 st block 
durinq read of un- 
blocked record. 

No EOF reportinq 
on unblocked reads. 







2.15.1 Special Control Specifications 
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Device 

(Bit 2=0) 

(Bit 2=1) 

Bit 8 

Bit 9 

Bit 10 

Bit 1 1 

Bit 12 

ALIM 

Read: receive 

M 

Bit 2 

Bit 8 Bit 9 


On Read: 



(Asynch- 

data (bytes) 

Read 0 

1 0 

=Blind mode reset 

1= Inhibit 



ronous 

defined for 

0 

0 1 

=Echo on read 

conversion of 



Line 

transfer count. 

1 

N/A N/A 

=Receive data 

lower case 



Interface 


0 

0 0 

=Receive data 

characters to 



Module) 

Write: formatted 




upper case 



Terminals 


Write 0 

N/A 0 

=Formatted write 

0= Convert 



(TV) 


0 

N/A 1 

=Initialize device 






1 

N/A N/A 

Unformatted write 




8-Line 

Read: perform 

Read:read 

T ransmit 

Read: 

Read (if 

Read: 

Read: 

Asynchronous 

special character 

n bvtes 

break 

0=Echo 

Bit 2=0):, 

0=no special 

0=do not purge 

Communications 

formatting. 

with no 

(erase, 

by con- 

0=convert lower 

character 

type ahead 

Multiplexer 


for- 

punch 

trolier 

case character 

detect 

buffer 

(TY) 

Write: first 

mattinq. 

trailer): 

l=No echo 

to upper case 

l=special \ 

l=purqe type 


character is for 


0=Stop 

by con- 

l=Inhibit 

character ) 

ahead buffer 


form control. 

Write n 

trans- 

trolier 

conversion of 

detept 




form 

mi t ting 


lower case 

* 




control. 

break . 

Write: 

characters to 

Write 





] =Star£ 

0=Normal 

tipper case. 

0=niormal write 





trans- 

write 


1=write with 


, 



mittinn 

l=Initialize 


input subchannel 





break. 

device (load 


monitorinq 





Read: 

UART 


plus software 





1= ASCII 

parameters) 


flow control 





control 








character 






• 


detect 







WORD 3 


Bits 0-31 Status Word - 32 indicator bits are used by IOCS to indicate the 

status, error and abnormal conditions detected during the current 
or previous operation. The assignment of these bits is shown 
below: 


Bit 

0 

1 

2 

3 

4 

5 

6 
7 


Meaning 

Operation in progress. (Request has been queued.) 

(Note: Reset after post I/O processing complete.) 

Error condition found. 

Invalid Blocking Buffer* control pointers have been encountered during file 
blocking or deblocking. 

Write protect violation. 

Device inoperable. 

Beginning-of-medium (BOM) (load point) or illegal volume number (multi- 
volume magnetic tape). 

End-of-file. 

End-of-medium (end of tape, end of disc file). 


Nonextended I/O Devices: 

8-11 Specifies general testing status as received from an 8000 level Test 

Device instruction. 

12-15 Specifies DCC testing status as received from a 4000 level Test Device 

instruction. 

16-31 Specifies a device status as received from a 2000 level Test Device 

instruction. These bits are not applicable for the Paper Tape, Card 
Reader, and Teletypewriter. Bit meanings for 2000 level testing for non- 
extended I/O devices are shown in Section 2.15.2. 
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f CB Word 
3 Bits 


All F- 
Class 
Devices 



CD 

TERMI- 

NATION 


INCORRECT PROGRAM DATA CONTROL INTERFACE CHANNEL BUSY 

LENGTH CHECK CHECK CHECK CHECK CHAINING 

CHECK 


ERROR STATUS FORMAT 
(See Word 3 description) 


DEVICE DEPENDENT 



FCB Word 
3 Bits 


ALL F- 

Class 

Device 


STATUS 

MODIFIER 


CONTROLLER ATTENTION CHANNEL DEVICE UNIT UNIT . 

END END END CHECK EXCEPTION 



EXTERNAL IOCB 
TERMINATION ADDR 
ERROR 


DEVICE TRANS- 

DEPENDENT MISSION 
ERROR 


ERROR 

ON 

71 ADDR 
FETCH 


DEVICE 

EOB 


EP5 

ERROR 

PRE- 

CLUDED 

REQUEST 

QUEUEING 


NONEXECUTIVE 
CHANNEL PROGRAM 
IOCB TYPE IN 
ERROR 

00- DATA TRANSFER 

01 - DEV STATUS 
10-COMMAND 
TRANSFER 


INCORRECT UNUSUAL ILLEGAL INTERRUPT CHANNEL 

LENGTH END ORDER 'PENDING END 


2*13.2 Device Status (2000 Level) Nonex 



















































For Extended I/O Devices Only 


Bit 

Meaning 

8 

Zero 

9 

Zero 

10 

Last command exceeded time out value and was terminated. 

11-15 

Zero 

16-23 

Channel status (see Section 2.15.3) 

24-31 . 

Controller/device status (see Section 2.15.3) 


2.15.3 Channel Status and Controller/Deviee Status for Extended I/O Devices 


Bit 

Description 


CHANNEL STATUS 

16 

Echo 



17 

Post program controlled interrupt 



18 

Incorrect length 



19 

Channel program check 



20 

Channel data check 



21 

Channel control check 



22 

Interface check 



23 

Chaining check 


controller/ 

24 

Busy 


DEVICE STATUS 

25 

Status modified 



26 

Controller end 



27 

Attention 



28 

Channel end 



29 

Device end 



.30 

Unit check 



31 

Unit exception . 
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WORD 4 


Bits 0-31 

WORD 3 
Bits 0-7 
Bits 8-31 

WORD 6 
BitO 
Bit 1 
Bit 2 
Bit 3 
Bit 4 
Bit3 5-7 
Bits 8-31 

WORD 7 
Bit 0-7 

Bits 8-15 

Note: Words 8 

WORD 8 
Bits 0-7 
Bits 8-31 
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Record Length - This field is used by IOCS to indicate the actual 
number of bytes transferred during read/ write operations. 

With execute channel requests and an error occurs this word will 
contain the residual transfer count from the request. 


Reserved. 

I/O Queue Address - This field is set by IOCS to point to the I/O 
queue for an I/O request initiated from this FCB. 


No wait normal end afction not taken 
No wait error end action not taken 
"Kill" command, I/O not issued 

If set, exceptional condition has occurred in the I/O request 
If set, software read flow control required. 

Reserved. 

Wait I/O Error Return Address - This field is set by the user and 
contains the address to which control is to be transferred in the 
case of an unrecoverable error when control bits 1 and 3 of word 2 
are reset. If this field is not initialized and an unrecoverable error 
is detected under the above conditions, the user is aborted. 


Index to FPT - This field points to the nth FPT in the File Pointer 
Table (FPT). 

FAT Address - This field points to the File Assignment Table (FAT) 
entry associated with all I/O performed on behalf of this FCB. 
This field is supplied by IOCS. 

■15 are valid only if Bit 6 of Word 2 is set. 


Reserved. 

Expanded Data Address - Start address of data area for read or 
write operations. Must be a word address. 

(or) 

Expanded Data/Command Chain Address - Word address that points 
to the data or commmand chain list if using execute channel entry 
point (H.IQCS,10). 
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WORD 9 
Bits 0-31 


WORD 10 
Bits 0-31 


WORD 11 
Bits 0-31 


WORD 12 
Bits 0-31 


WORD 13 
Bits 0-7 

Bits 8-31 


Expanded Quantity - Number of bytes of data to be transferred. 

(or) 

For GPMC devices which support data/command chaining: 
Expanded Number of Data/Command Chain Doublewords. If 
data/command chaining is desired (execute channel H.IOCS,10), 
this is used to indicate the number of data/command chain 
doublewords in the list. 


Expanded Random Access Address - This field contains a block 
number (zero origin) relative to the beginning of the disc file. It is 
the start address for the current read or write operation. 

(or) 

For High Speed Data (HSD) Interface requests in non-Execute 
Channel Program format, this word defines a device command. 


Status Word 1 - For extended I/O, these are the 32 bits returned by 
the SENSE command. 

(or) 

For communications adapter interface, external asynchronous 
interrupt (EAI) status if Bit 12 of Word 2 is set. 


Status Word 2 - Second status word as returned from the Extended 
I/O hardware. 

(or) 

For High Speed Data (HSD) Interface applications, this word 
contains status sent from the user's device. 


Reserved. 

No-Wait I/O normal completion service address return. This user 
service must be terminated by calling H.IOCS,34 (no-wait I/O end 
action return). 

(or) 
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WORD 14 
Bits 0-7 
Bits 8-31 

WORD 13 
Bits 0-7 

Bits 8-31 
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For High Speed Data (HSD) Interface applications, this address plus 
1 word is the location to which control is transferred on 
asynchronous notification. 


Reserved. 

No-Wait I/O error completion service address return. This user 
service must be terminated by calling H.IOCS,34 (no^-wait I/O end 
action return). 


Number of 192 W buffers if specifying large blocking buffers. A 
value of one or zero in this field specifies one blocking buffer. 

Blocking Buffer Address - Defined for device independent I/O or a 
Post Programmed Controlled Interrupt End Action Receiver for 
device dependent I/O. 
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2.16 File Pointer Table (FPT) 

The File Pointer Table (FPT) provides the linkage between the File Control Block (FCB) 
and the File Assignment Table (FAT). It also allows for multiple logical file code 
assignments to be equivalenced to the same FAT. The linkage to the FAT is performed 
at assignment. The linkage to the FCB is performed at opening. The FPT resides in the 
task's service area. 

FPT entries 1-6 are reserved for the system as follows: 

Entry 1 - System LFC *s* 

Entry 2 - Load module LFC *LM 

Entry 3 - H.VOMM resource descriptor LFC (1) 

Entry 4 - H.VOMM directory LFC (2) 

Entry 5 - H.VOMM DMAP/SMAP LFC (3) 

Entry 6 - H.VOMM modify resource descriptor LFC X'FFFEE' 

Each FPT entry has the following format: 


Word 0 7 8 


Reserved 

Logical file code (FPT. LFC) 

Flags 

(FPT.FLGS) 
See Note 1 

FCB address (FPT. FCB A) 

Reserved 

FAT address {FPT. FAT A) 


Notes 

1. Bits in FPT.FLGS are assigned as follows 

0 Reserved 

1 If set, multiple FPT entries exist which point to the same FAT (i.e., $ASSIGN4 
or $ASSIGN lfc TO LFC=lfc statements) 

2 Reserved 

3 If set, FPT open 

4 If set, this FPT entry is not in use 

5 If set, pseudo SYC assignment (used by TSM) 

6 If set, pseudo FPT for unassigned temporary file 

7 Reserved 
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2.17 I/O Queue (IOQ) Entry 


l he I/O Queue (IOQ) Entry is dynamically allocated from memory pool and contains 
information required to queue and process an I/O request. These entries are variable in 
length and support multiple device commands which are built starting at the end of the 
standard IOQ entry. The I/O queue consists of one or more I/O Queue Entries linked to 
either a Controller Definition Table (CDT) or a Unit Definition Table (UDT). 


Word 0 


7 8 


15 16 


23 24 


31 


String forward address (IQu.Sr A) 


String backward address (IQQ.SBAj 
I/O type " 
(IOQ.TYPE) 


Queue priority 

(IQQ.PRI) 

Reserved (IQQ.RTN) 


Channel number 
(IOQ.CHNO) 


Subaddress 

(IOQ.SUBA) 


PSD1 of task interrupt routine (IQQ.PSD) See Note 1 


PSD2 of task interrupt routine 


Status 
(IOQ.STAT) 
See Note 2 


FCB or TCPB address 
(IOQ.FCBA) 


Program 

number 

(IOQ.PRGN) 


CDT address 
(IOQ.CDTA) 


8 

9 

10 
11 


Handler function word 1 (IQQ.FCT1) 


Handler function word 2 (IQQ.FCT2) See Note 3 


Handler function word 3 (IOQ.FCT3) See Note 4 


Handler function word 4 (IOQ.FCT4) 


r Y ir 

32-Bit flag word (IOQ.FLGS) See Note 5 

13 

FAT address (IOQ.FATA) 

14 

Number of bytes transferred 
(IOQ.UTRN) See Note 6 

Number of words in OS buffer 
(IOQ.WOSB) See Note 6 

15 . 

OS buffer address (IOQ.FBUF) 

^16 

User’s buffer address (IOQ.TBUF) . 

17 

I/O returned status word 1 (IOQ.I0ST) 1 ’ 

t n 
iO 

I/O returned status 

word Z (iOQ.iSTl) bee Note / 5 i 

19 

I/# returned status word 3 (IOQ.IST2) Sbe Note 1 

Mil 

UDT address (IOQ.UDTA) 1 i 

21 

Control information from word 2 of FCB (IOQ.CONT) 

22 

Address of context block (IOQ.CBLK) or 
Device context area address (IOQ.DCAA) 

23 

Mode bits 
(extended I/O) 
(IOQ.MODE) 

See Note 9 or 
Word address of 
set mode bits 
(IOQ.MOWD) 

Queue priority 
temporary storage 
(IOQ.PSAV) 

Number of extra words in this 
queue entry (IOQ.XTRA) 

24 

Device inoo buffer address (for I/O error Drocessing) (IOQ. INOP) j 

25 

Address of first word of dynamic IOCD list (extended I/0)(I0Q.I0CD) See Note 10 | 
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Notes 


1. For no-wait I/O this field is set to point to the I/O post processing routine 
(S.IOCS1). When I/O completes, control will be passed to this service. 

2. Bits in IOG.STAT are assigned as follows. 

0 If set, I/O queue is active (Note: Reset by device handler when physical I/O 
transfer completes.) 

1 If set, sense command was issued on behalf of this I/O request (extended I/O) 

2 If set, error retry was issued (rezero and retry entire IOCD list) (extended I/O) 

3 If set, operator intervention required; do not restart I/O 

4 Reserved 

3 If set, read ECC was issued (extended I/O) 

6 If set, error retry was issued (retry entire IOCD list) (extended I/O); 

backspace write or read sequence performed for extended I/O tape 

7 Reserved 


3. For extended I/O devices, IOQ.FCT2 contains the 24-bit virtual address of the data 
(or) IOCL. (Bits 0-7=0) 

4. For extended I/O devices, IOQ.FCT3 contains the adjusted byte transfer count in 
bits 0-31 (maximum is C.ADMASK+1). 


3. 


•r 


Bits in IOQ.FLGS are assigned as follows. 

0 If set, multiplexed controller 

1 If set, OPCOM console request 

2 If set, TCW has been absolutized 

_JL, Jf set, TOO will hp> linked to the UDT not the CDT 

4 If set, deallocate OS buffer 

5 If set, extended I/O 

6 If set, error found 

_ 7 ^ If set, system console queue 

8 If set, data move required (OS to user buffer) 

9 If set, rewind command in IOCD list for magnetic tape or Reserve command 

in IOCD list for disc (extended I/O) 

10 If set, nonexecute channel read command (extended I/O) 

If set, nonexecute channel write command (extended I/O) 

12 If set, special handler post processing required (Handler EP6) 

13 H.CT00 has been called with an FCB, not with a TCPB (i.e., not via 

H.IOCS,14) 


14 Reserved 

If set, terminal input 
If set, terminal output 

17 If set, task swappable during I/O 

18 If set, release command in IOCD list for disc (extended I/O) 
No-wait I/O (not TSM) 

20 ’ If set, I/O restart" entry 

21 If set, nondevice access I/O performed 

22 Kill command issued for this I/O request 
If set, execute channel program (extended I/O) 

If set, user privileged 

23 D-class controller (GPMC) only 

26 Physical I/O performed on behalf of a user requesting blocked I/O 
27-28 Reserved 

29 If set, EOF testing required for disc 
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30 If set, movement in file is in negative direction 

31 If set, continuous EOF search (disc and floppy disc only) 

5 . For extended I/O devices, IOQ.UTRN is a full word (Bits 0-31) and IOQ.WQSB is not 
applicable. 

7. For extended I/O devices, IOQ.IST1 is initialized to the start address within the I/O 
queue for any dynamic IOCD's. 

8. For extended I/O devices, IOQ.IST2 is initialized to the stop address within the I/O 
queue for any dynamic IOCD's. 

9. Mode bits are peculiar to each device. 

10. This cell contains the absolute data (or) IOCL address associated with the I/O 
request. 
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TSA 

1) FPT 
21 FAT 
3) SDT 
41 VAT 

SYSTEM RESIDENT 


1) IOQ 

2) MVT 

3) ART 

4) SMT 

6) yOT., . - 
,6T-'/ : CDT. ,!: ' ' 

?l OTt ' 

USER SUPPLIED 

FOB 

LINK ESTABLISHMENT 

A - AT ASSIGNMENT 
S ■ ATSVSGEN 
0 - AT OPEN 

M * AT VOLUME MOUNT 
OP - AT OP CODE PROCESSING 


2.18 I/O Table Linkages 











r = VDTdpJ, 

239 Unit Definition Table (UDT) / 

The Unit Definition Table (UDT) is\a system resident structure used to identify device 
dependent information required by 1 handler for a specific device. The UDT is > built _by 
the SYSGEN process, one for each device configured in the system. During S , 

each UDT is linked to its corresponding Controller Definition Table (CDT) and 
consequently its associated controller/ and handler. 

Word 0 7 8 rz i 6 f 15 16 23 24 


UDT index- (UDT.UDTI) 3 
Unit status Device type 

(UDT.STAT) code (UDT.DTC) 

See Note 1 ^ , . See Note 2 _ , 

% u * 1 


Reserved 

Physical 

channel 

number 

(UDT.PCHN) 


! c / J 15 16 23 24 ^.Z 51 

II) 3 'zzsn ll CDT index (UDT.CDTI) 

Device type Logical' P Logical sub- ~ 

code (UDT.DTC) channel * - address (UDT.SUBA) 

See Note 2 4 _ number T'°- C '' c < 

(UDT. CHAN) 

Address of Dispatch Queue entry of f 

task which has device allocated if device is not shared * 

PJDT.DQEA) — 

Physical sub- * Sectors per Sectors per aUocatioi 

address block v unit (UDT.SPAU) 

(UDT.PSUB) (UDT.SPB)^. 

,or ~--q 1 or J 

t S Number Number lines per 

( characters screen (UDT .LINE) 

• per line % See Note 4 

(UDT. CHAR) 

See Note 3 


Sectors per allocation 
unit (UDT.SPAU) 


Number lines per 
screen (UDT.LINE) 
See Note 4 


if a terminal (UDT. SECS) ^ ^ 

T Number of heads on disc or a tab seating 


Number of sectors 

Flags 7^ per track on Maximum byte transfer 

(UDT.FLGS)O disc or global (UDT.MBX) 

See Note 5 line counter if a 

terminal (UDT.SPT)I ^ 

Number of sectors oh disc or tab setting if a terminal (UD T. SECS) ^ 

Sector size, on disc or a " Number of ^ads on di^sc or a - seu.i 

tab setting if a terminal if a terminal (UDT.NHDS) 

(UDT.SSIZ) _ l 

.Serial number if tape or removable disc (UDT.5ERN) ^ 

Periph eral time out value (UDT.PTOV) - — : — 

Reserved Address of device context area (UD-l-rDCAAior Handler jiame 

. at initialization (UDT .HNAM ) — Y * L -' \ ' L r - 

Bit flags See Note 5 (UDT.BIT2) " Associated. Allocated Resource Table 

1 index if assigned (UDT. ARTI) 

/ k — 


^ if a terminal (UDT.NHDS) 


Service interrupt handler address XjJ^«5IHA) -***' "y 

Device historical data address (UP , 

Address of first IOQ linked^fce-this device (UDT.HQQ^ 

Address of last IOQ linked to this device (UDT.BIOQ) 

Link Priority Link Count Unit Status byte 2 

(UDT.LPR1) (UDT.IOCT) 


TA2; See Note 


/ V 
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Notes 


1. Bits in UDT.STAT are assigned as follows. 

0 If set, on-line (UDT.ONLI) 

1 If set, dual ported XIO disc (UDT.DPDC) 

2 If set, allocated (UDT.ALOC) 

3 If set, in use (UDT.USE) 

4 If set, system output unable to allocate (UDT.NOAL) 

5 If set, shared device (UDT.SHR) 

6 If set, premounted (UDT.PREM) 

7 If set, terminal (TSM) device (UDT.TSM) 

2. For example, 01 for any disc; 04 for any tape, etc. Valid device type codes are 
listed in Appendix A of the MPX-32 reference manual 

3. For discs, contains number of sectors per block (UDT.SPB). For terminals, contains 
number of characters per line (UDT.CHAR). 

4. For discs, contains number of sectors per allocation unit (UDT.SPAU). For 
terminals, contains number of lines per screen (UDT.LINE). 


3. Bits in UDT.FLGS are assigned as follows. 

0 If set, extended I/O device (UDT.FCLS) 

1 If set, I/O outstanding (UDT.IOUT) 

2 If set, removable disc pack (UDT.RMDV) 

3 _ _ If set, terminal user logged on (UDT.LOGO) 

4 If set, autoselectable for batch SLO (UDT.BSLO) 

5 If set, autoselectable for batch SBO (UDT.BSBO) 

6 If set, autoselectable for real-time SLO (UDT.RSLO) 

7 If set, autoselectable for real-time SBO (UDT.RSBO) 


6. Bits in UDT.BIT2 are assigned as follows. 

f -1 Tf i. ; I :«._1 i f\ ir^T nTAI > 

u n set, port is private; eise swituneu \uu i .uiml; 

1 If set, port is connected to modem (UDT.MODM) 

2 If set y port has graphic capability (UDT.GRFC) 

3. If set, port is full duplex (UDT.FDUX) 

4 If set, port is configured multidrop (UDT.MDRA) 

5 If set, volume mounted on device (UDT.VOL) 

6 If set, echo by computer (UDT.ECHO) 

7 Device has failed. Log off TSM (UDT.DEAD) 

*T~ If set, cache device (UDT.CAC) 

9 If set, inhibit automatic line wrap (UDT.NRAP) 

1*0 Reserved 

11 If set, quarter inch cartridge tape drive (UDT.QITD) 

If set, software read flow control required (UDT.RXON) 

If set, software write flow control required (UDT.WXON) 
If set, hardware read flow control required (UDT.RHWF) 
If set, hardware write flow control required (UDT.WHWF) 


7. Bits in UDT.STA2 are assigned as follows. 

0 If set, IOQ linked from UDT (UDT.IOQ) 

1 If set, IOP device (initialized by SYSGEN) (UDT.IOP) 

2 If set, device malfunction (UDT.MALF) 

3 If set, operator intervention applicable (UDT.INTV) 

4 If set, use standard XIO interface 
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Table 5-6 

Device Functions (Terminals, Handler Action Only) 


Operation 

IOCS 

Op 

Code 

Handler = H.ASMP 
(ALIM) 

Handler = F8XIO 
(8-Line) 

Open 

M.FILE 

0 

NOP 

Initialize IOP 
Channel if Necessary 

Rewind 

M.RWND 

1 

NOP 

SENSE Operation 

Read Rec. 
M.READ 

2 

Read to Data 
Buffer 

Read to Data 
Buffer 

Write Rec. 
M.WRIT 

3 

Write Record to 
Terminal 

Write Record to 
T erminal 

Write EOF 
M.WEOF 

4 

NOP 

NOP 

Execute 

Channel 

5 

Execute Channel 

Execute Channel 

Advance 

Record 

M.FWRD 

6 

Connect Communi- 
cations Channel 

Set Data Terminal 
Ready 

Advance 

File 

M.FWRD 

7 

Disconnect Com- 
munications 
Channel 

Reset Data 
Terminal Ready 

Backspace 

Record 

M.BACK 

8 

Initialize Dev- 
ice and Set 
Timeout Value 

Used by 3.TINIT to 
Initialize Terminals 

Backspace 
File M.BACK 

9 

Clear Break 
Status Flag Word 

Reset Request to 
Send 

Upspace 

M.UPSP 

A 

Spec Error 

Set Request to Send 

Erase/Punch 

Trailer 

B 

Transmit Break 

Set/Reset Break 
(depends on flags 
in FCB) 

Eject/Punch 

Leader 

M.EJECT 

C 

Spec Error 

Define Special 
Character 

Close 

M.CLSE 

D 

NOP 

NOP 

Reserve FHD 
Port 

E 

Spec Error 

Set Single Channel 
Operation (Default) 

Release FHD 

F 

Spec Error 

Set Dual Channel Operation 


Port 

NOP = No operation performed Spec Error = Illegal operation code 
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MPX-32 Resource Assignment/Allocation 
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T^ble 5-8 

Default and Special Device Formatting (Page 2 Of 2) 


Device 

(Bit 2=0) 

(Bit 2=1) 

Bit 8 


Bit 9 

Bit 10 

Bit 11 

Bit 12 

Mag Tape 
(MT, 7- 
track only) 

Binary, ODD 
parity, 800 bpi 

See Bits 8-10 

< 4 . 

0=lnterchange 
(binary coded 
decimal) 

l=Packed (binary) 

If Bit 8=0: 
0=EVEN parity 
l=ODD parity 

0=800 bpi 
1=556 bpi 



(MT 9- 
track only) 

N/A 

— 






Discs 

(DM,DF,FL) 

Report EOF if 
X'OFEOFEOF' en- 
countered in word 
0 of 1st block 
during read of un- 
blocked record 

No EOF reporting 
on unblocked reads 






ALIM 

(Asynch- 

ronous 

Line 

Interface 

Module) 

- Terminals 
(TY) 

Read: receive 
data (bytes) 
defined for 
transfer count 

Write: formatted 

Bit 2 Bit 8 Bit 9 

Read 01 0 

0 0 1 

1 N/A N/A 

0 0 0 

Write 0 N/A 0 

0 N/A 1 

1 N/A N/A 

=Blind mode reset 
=Echo on read 
^Receive data 
=Receive data 

=Formatted write 
^Initialize device 
=Unformatted write 

On Read: 

1= Inhibit 

conversion of 
lower case 
characters to 
upper case 
0= Convert 



8-Line 

Asynchronous 

Communications 

Multiplexer 

(TY) 

Read: perform 
special character 
formatting. 

Write: first 
character is for 
form control. 

Read: if format- 
matting is 
inhibited, reads 
n bytes. 

Write n bytes 
with form 
control. 

Transmit 

break 

(erase, 

punch) 

(trailer): 

0=Stop 

trans- 

mitting 

break 

l=5tart 

trans- 

mitting 

break. 

Read: 

1=ASCII 

control 

character 

detect 

Read: 
0=Echo 
by con- 
troller 
l=No echo 
by con- 
troller 

Write: 

0=Normal 

write 

l=Initialize 
device (load 
UART 
parameters) 

Read (if 
Bit 2=0): 
0=convert lower 
case character 
to upper case 
l=Inhibit 
conversion 

Read: 

0=no special 

character 

detect 

l=special 

character 

detect 

Write 

0=norma! write 
l=write with 
input subchannel 
monitoring plus 
software flow 
control 

Read: 

0=do not purge 
type ahead 
buffer 

1 spurge type 
ahead buffer 


i> 
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Table 5-9 Standard T erminal and Line Printer 
Carriage Control Characters and 
Interpretation 

Result 


Control 

Character 

Hex 

Value 

Result on a 
Terminal 

Result on a 
Line Printer 

Blank 

20 

One linefeed/carriage 
return before write. 

Single space 
before print. 

0 

30 

Two linefeed/carriage 
returns before write. 

Double space 
before print. 

1 

31 

Five linefeed/no 
carriage returns 
before write. 

Page eject (slew) 
before print. 

+ 

2B 

No linefeed/carriage 
return before write 
(line append). 

No space before 
print (overprint). 


2D 

Five linefeed/carriage 
returns before write. 

Page eject, save and 
print up to three user 
supplied title lines. 
See Note 1 
See Note 2 

< 

3C 

One linefeed/carriage 
return before write. 

Set inhibit spooler 
title line in this file. 
See Note 2 

> 

3E 

One linefeed/carriage 
return before write. 

Set enable spooler 
title line in this file. 
See Note 2 


3D 

One linefeed/carriage 
return before write. 

Page eject and clear 
up to three user 
supplied title lines 
in this file. 

See Note 2 


Notes: 

1. User supplied title lines have the same effect as this character. Supplying a 
fourth title line clears the first three, but only one page is ejected. User 
supplied titles are retained by the spooler and are repeated at the top of each 
page until cleared or the spool file ends. 

2. If the line printer is directly allocated this character is processed as a blank and 
the spooler title line is not produced. 
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[{A) 0L 

~~L a^o~cA 



The M.MEMB service allows the task to dynamically expand its memory allocation in 
doubleword increments starting at the end of its DSECT up to the top of its logical 
address space. The additional memory will be of the same type specified when the tas«< 
was cataloged. The task will be mapped in a logically contiguous manner up to the end o 
its address space. The task will be suspended until the allocation is successful. Repeated 
calls to this service are allowed. Allocation will not be contiguous with previously 

allocated space. 

't- u : ~ mcd^ 1 r> rrininnrtion With t^0 OP M#GD SCPVlCCS* 

i ni> ser v ICc Ccli mOi uoco .jU. vy _ u- . .v. 

The base mode equivalent service is M_GET ME MBYTES. 




fc& 


Entry Conditions 


Calling Sequence: 

M.MEMB num 
(or) 

LW R4,=num (or) LI R4,num 

SVC 2,X'4B' (or) M.CALL H.REMM,28 

where: 

num is the number of bytes to allocate - 

f 

Exit Conditions 

Return Sequence: 

M.RTRN R3,R4 

Registers: 

CC1=0 

CC2=0 

R 3 contains the 24-bit starting logical doubleword address of allocated 

% space 

R 4 contains the number of bytes actually allocated (modulo 2W) 

(or) 

CCUO 
CC2=i < 

R 3 contains the 24-bit starting logical doubleword address of allocated 

space 

R4 contains the number of bytes actually allocated (modulo 2W). 

However, the number is less than requested. 
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Error Conditions 


Allocation Denied: 

CC1 = 1 
CC2=1 


R3=0 

m=o 


- MPX-32 
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S.2.106 M.MEMFRE - Free Memory in Byte Increments 

The M.MEMFRE service allows the task to dynamically deallocate acquired memory. 
Deallocation can be random. The space address must have been Prev^yob^med from 
the M.MEMB service. All of the space obtained from a given call is deallocated. 

This service cannot be used in conjunction with the M.FE or M.FD services. 

The base mode equivalent service is M_FREE ME .MBYTES. 


E n t r y Conditions 


Calling Sequence: 


M.MEMFRE addr 


(or) 

LW R3,addr 

SVC 2,X’4C 1 (or) M.CALL H. RE MM, 29 


where: 

addr 


is the starting address of a previously acquired dynamic space from 
the M.MEMB service 


Exit Conditions 
Return Sequence: 

M.RTRN R3 (or) abort user with RM77 


Registers: 

P3_q if deallocation could not be performed. Deallocation address was not 

found in allocation table. 


Abort Cases: 
RM77 


A task has destroyed the allocation linkages in this dynamic expansion 
space. 
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S.2.13Q M.READ - Read Record 

The M.READ service performs the following functions: 

Provides SDecial random access handling for disc files..-. 

Deblocks system files and blocked files. 

Reads one record into the buffer indicated by the Transfer Control Word (T("V) in 
the ren, 

The base mode equivalent service is M READ. 

Entry Conditions 
Calling Sequence: 

M.READ feb 
(or) 

LA l,fcb 

SVC 1,X'31' (or) M.CALL H.IOCS,3 

where: 

fcb is tbe PCB address. Appropriate transfer control parameters are 

defined in the TCW (see Section 7.9. 1.2). 


Exit Conditions 


Return Sequence: 


M.RTRN 


Registers: 


•None 


Abort Cases: 
1003 

1006 

1026 

1030 

1032 


Nnnprivilpged user attempting transfer tn n lngicn! address outside 
legal boundaries. 

Invalid blocking buffer control cell for a system or blocked file. 

Read attempted for a system or blocked file while write in process. 
Illegal volume record. Either volume number or reel ID from volume 
record do not match FAT information. 

Second attempt to read a $ statement in a 5YC file. 


Output Messages: 


DISMOUNT/MOUNT messages if EOT and multivolume magnetic tape 
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8.2.13 i M_READ - Read Record 

The \1_READ service performs the following functions: 

Provides special random access handling for disc files. 

Deblocks system files and blocked files. 

Reads one record into the buffer indicated bv the Transfer Control Word (TCW1 in 
the FCB. 


The nonbase mode equivalent service is M.READ. 
Entry Conditions 


Calling Sequence: 

M_PFAD [FCMDDR J.ulrtr 

(or) 

SVC l.X'31' (or) M.CALL H.IOCS,3 

where: 

addr is the FCB address. Appropriate transfer control parameters are 

defined in the TCW (see Section 7.9. 1.2). 

Registers: 

R 1 contains addr 

n \/ l + C* l + i 

uau lumui io 

Return Sequence: 

M.RTRN 
Registers: 

None 

Abort Cases: 

1003 

1006 
1026 
1030 

1032 

Output Messages: 

DISMOUNT/MOUNT messages if EOT and multi volume magnetic tape 


Nonprivileged user attempting transfer to a logical address outside 
legal boundaries. 

Invalid blocking buffer control ceil for a system or blocked file. 

Read attempted for a system or blocked file while write in process. 
Illegal volume record. Either volume number or reel ID from volume 
record do not match FAT information. 

Second attempt to read a $ statement in a SYC file. 
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8.2.173 M.WRIT - Write Record 


The M.WRIT service performs the following functions: 
Prevents a write to a read-oniv file. 


Provides special random access handling for disc files. 


Blocks records for system and blocked files. 


Writes volume record if BOT on muitivolume magnetic tape. 

Performs ERASE/WRITE EOF if EOT on multivolume magnetic tape. 
Writes one record from the buffer pointed to by the TCW in the FCB. 
The base mode equivalent service is M_WRITE. 

Entry Conditions 
Calling Sequence: 

M.WRIT fob 


(or) 

LA 

SVC 

where: 

fcb 

Exit Conditions 


l,fcb 

1,X’32' (or) M.CALL H.IOCS,4 


is the FCB address 


Return Sequence: 
M.RTRN 
Registers: 

None 

Abort Cases: 


1006 

1009 

1027 

1038 


Invalid blocking buffer control cell for a system or a blocked file. 
Illegal operation on the SYC file 

Write attempted while reading from a system or a blocked file. 
Write attempted on a file opened in read only mode. 


Out du t Messages: 


n I $ M OUNT/\ 1 0 U N T 


messages if EOT on multivolume magnetic tape 
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